cfgportip

Use o comando cfgportip para designar um endereço Internet Protocol (IP) a cada porta Ethernet do nó para entrada/saída (E/S) Internet Small Computer System Interface (iSCSI).

Sintaxe

Para Protocolo da Internet Versão 4 (IPv4) e Protocolo da Internet Versão 6 (IPv6):
Nota: O IPv6 não é suportado no IBM Cloud.
Ler diagrama de sintaxeManter visual do diagrama de sintaxe cfgportip -node nome_do_nónó_de_nó -ipipv4addr-masksubnet_mask-gwipv4gw-ip_6ipv6addrprefix_6prefix-gw_6ipv6gw-failover -host yesno-host_6yesno-remotecopyremote_copy_port_group_id-remotecopy_6remote_copy_port_group_id -vlan vlan_id_ip4-novlan-vlan_6 vlanid_ip6-novlan_6-storageyesno-storage_6yesno-force port_id

Para a unidade de transmissão máxima (MTU):

Ler diagrama de sintaxeManter visual do diagrama de sintaxecfgportip-mtu mtu-defaultmtu -iogrp io_grp_id io_grp_nameport_id

Paramêtros

-node node_name | node_id
(Obrigatório) Especifica qual nó tem a porta Ethernet à qual o endereço IP está sendo designado.
Nota: Este parâmetro é necessário para configurar um endereço IP da porta. Ele não pode ser usado com o parâmetro -mtu.
-ip ipv4addr
(Obrigatório) Configura o endereço do Internet Protocol Versão 4 (IPv4) para a porta Ethernet. Não é possível usar esse parâmetro com o parâmetro ip_6.
-ip_6 ipv6addr
(Obrigatório) Configura o endereço do Internet Protocol Versão 6 (IPv6) para a porta Ethernet. Não é possível usar esse parâmetro com o parâmetro ip.
-gw ipv4addr
(Obrigatório) Configura o endereço IP do gateway IPv4. Não é possível usar esse parâmetro com o parâmetrogw_6.
-gw_6 ipv6gw
(Obrigatório) Configura o endereço de gateway padrão IPv6 para a porta. Não é possível usar esse parâmetro com o parâmetro gw.
-mask subnet_mask
(Obrigatório) Configura a máscara de sub-rede IPv4. Não é possível usar esse parâmetro com o parâmetro prefix_6.
-prefix_6 prefix
(Obrigatório) Configura o prefixo IPv6. Não é possível usar esse parâmetro com o parâmetro mask.
-failover
(Opcional) Especifica que o endereço IP pertence ao nó parceiro no grupo de E/S. Se o nó do parceiro não estiver configurado ou off-line, o endereço será configurado e apresentado por esse nó. Quando outro nó ficar on-line no grupo de E/S, o endereço de failover será apresentado por esse nó.

Se o nó do parceiro estiver on-line, não use essa opção.

-mtu mtu | -defaultmtu
(Obrigatório) Especifica a unidade de transmissão máxima (MTU). O padrão é 1500, com um máximo de 9000. Uma MTU de 9000 permite salvar a utilização de CPU para pacotes com tamanho de 4 KB e acima. A MTU aumentada fornece um melhor desempenho do Internet Small Computer System Interface (iSCSI). Especifique -defaultmtu para usar o valor padrão.
Notas: Este parâmetro tem as seguintes restrições:
  • Este parâmetro deve ser usado quando você estiver configurando ou alterando o valor de MTU do sistema.
  • Este parâmetro não pode ser usado com o parâmetro -node.
-iogrp iogrp
(Opcional) Especifica o grupo de E/S que contém os nós para modificar.
-host yes | no
(Opcional) Especifica o endereço IPv4 que é usado para conexão de host (as configurações do sistema existentes são retidas). Especificar:
  • yes relata o endereço IPv4 para hosts durante a descoberta de destino (padrão)
  • no desativa esse relatório (endereços IPv4 não são relatados durante a descoberta do host).
-remotecopy remote_copy_port_group_id
(Opcional) Especifica o endereço IPv4 que é usado para a função de cópia remota. A cópia remota inclui Metro Mirror e Global Mirror. Também especifica o ID para o grupo da porta associado. Esses IDs são valores numéricos (0, 1 ou 2) que especificam que os endereços IP em um sistema podem fazer parte de uma parceria de um login. Para formar um login, os endereços IP devem estar no mesmo grupo da porta. O padrão é 0, que indica que a porta não está disponível para parcerias.
Importante: Para incluir ou excluir portas para ou de um grupo de replicação, certifique-se de que a parceria que usa esse grupo da porta esteja em um estado pausado.
-host_6 sim | não
(Opcional) Especifica o endereço IPv6 que é usado para conexão de host (as configurações do sistema existentes são retidas). Especificar:
  • yes relata o endereço IPv6 para hosts durante a descoberta de destino (padrão).
  • no desativa esse relatório (endereços IPv6 não são relatados durante a descoberta do host).
Nota: Desativar configurações de conexão do host de um endereço IP que está configurado como yes causa interrupção porque todas as sessões iSCSI do host para esse endereço IP são desconectadas.
-remotecopy_6 remote_copy_port_group_id
(Opcional) Especifica o endereço IPv6 que é usado para a função de cópia remota. A cópia remota inclui Metro Mirror e Global Mirror. Também especifica o ID para o grupo da porta associado. Esses IDs são valores numéricos (0, 1 ou 2) que especificam que os endereços IP em um sistema podem fazer parte de uma parceria de um login. Para formar um login, os endereços IP devem estar no mesmo grupo da porta. O padrão é 0, que indica que a porta não está disponível para parcerias.
Importante: Para incluir ou excluir portas para ou de um grupo de replicação, certifique-se de que a parceria que usa esse grupo da porta esteja em um estado pausado.
-vlan vlanid_ip4
(Opcional) Configura o ID da rede local virtual (VLAN) para um endereço IPv4 configurado para a função de conexão ou de cópia remota do host iSCSI. A cópia remota inclui Metro Mirror e Global Mirror. O ID da VLAN para um endereço do tipo IPv4 pode ser especificado somente se o endereço IP para essa porta estiver configurado. A identificação de VLAN está desativada para qualquer endereço IP, de modo que um ID de VLAN deve ser especificado usando -vlan para ativar a identificação de VLAN.
Lembre-se: Use -vlan com cuidado. É possível:
  • Reconfigurar as configurações de VLAN, que podem interromper a comunicação da porta (conexão) com hosts ou sistemas (incluindo a reconfiguração do ID de VLAN para uma parceria de IP ou iSCSI ativa)
  • Reconfigurar um valor de VLAN para uma porta que não possui a identificação de VLAN ou não possui um endereço IP configurado

O ID de VLAN pode ser configurado para a porta de failover que usa o atributo -failover.

-novlan
(Opcional) Desativa a identificação de VLAN de um endereço IPv4 para uma porta Ethernet (o que significa que nenhuma identificação de VLAN está associada a essa porta).
-vlan_6 vlanid_ip6
(Opcional) Configura o ID da rede local virtual (VLAN) para um endereço IPv6 que está configurado para a função de conexão do host iSCSI ou de cópia remota. A cópia remota inclui Metro Mirror e Global Mirror. O ID da VLAN para um endereço do tipo IPv6 pode ser especificado somente se o endereço IP para essa porta estiver configurado. A identificação de VLAN está desativada para qualquer endereço IP, de modo que um ID de VLAN deve ser especificado usando -vlan para ativar a identificação de VLAN.
Lembre-se: Use -vlan_6 com cuidado:
  • A reconfiguração de configurações de VLAN pode interromper a comunicação da porta (conexão) com hosts ou sistemas, incluindo a reconfiguração do ID de VLAN para uma parceria de IP ou iSCSI ativa.
  • É possível reconfigurar uma identificação de VLAN para uma porta que não possui a identificação de VLAN ou não possui um endereço IP configurado.

O ID de VLAN pode ser configurado para a porta de failover usando o atributo -failover.

-novlan_6
(Opcional) Desativa a identificação de rede local virtual (VLAN) para um endereço IPv6 para uma porta Ethernet (o que significa que nenhuma identificação de VLAN está associada a essa porta).
Lembre-se: Use -novlan_6 com cuidado:
  • A reconfiguração de configurações de VLAN pode interromper a comunicação da porta (conexão) com hosts ou sistemas, incluindo a reconfiguração do ID de VLAN para uma parceria de IP ou iSCSI ativa.
  • É possível reconfigurar uma identificação de VLAN para uma porta que não possui a identificação de VLAN ou não possui um endereço IP configurado.
-storage yes | no
(Opcional) Especifica se um endereço IPv4 pode ser usado para a função de conexão de armazenamento de backend. O valor yes indica que esse endereço IPv4 pode ser usado para descoberta de destino iSCSI e conectividade de armazenamento de backend. Deve-se especificar no (padrão) se você não estiver usando o endereço IP de conexão de armazenamento. Se o endereço IPv4 associado a uma porta específica (em um nó) for mudado, as configurações de conexão de armazenamento existentes serão retidas. Os valores são yes e no.
-storage_6 yes | no
(Opcional) Especifica se um endereço IPv6 pode ser usado para a função de conexão de armazenamento de backend. O valor yes (o padrão) indica que esse endereço IPv6 pode ser usado para a descoberta de destino iSCSI e a conectividade de armazenamento de backend. Deve-se especificar no se você não estiver usando o endereço IP de conexão de armazenamento. Se o endereço IPv6 associado a uma porta específica (em um nó) for mudado, as configurações de conexão de armazenamento existentes serão retidas. Os valores são yes e no.
-force
(Opcional) Força uma mudança de endereço IP para uma porta Ethernet do nó mesmo que isso faça com que os controladores de backend iSCSI sejam removidos ou que os MDisks entrem em um estado comprometido ou off-line.
Importante: Use o atributo force raramente para evitar uma perda de acesso a um nó ou um MDisk.

Mudar atributos de endereço IP pode fazer os MDisks irem para um estado comprometido por algum tempo. Se um endereço IP de origem estiver em uso para conectividade do controlador de backend iSCSI, a mudança do endereço IP, da máscara de sub-rede ou do gateway de IP removerá as sessões existentes e estabelecerá novas sessões. Durante essa fase, os MDisks visíveis por meio da porta de origem que está sendo reconfigurada entram em um estado comprometido por um curto tempo até que novas sessões sejam estabelecidas.

É possível usar a sinalização -force para continuar com a reconfiguração se você compreende todos os riscos envolvidos. Se você estiver inseguro quanto ao que pode acontecer, use o atributo force apenas sob a orientação de sua equipe de suporte.

Se estiver incluindo um novo grupo de E/S em um sistema, a mensagem CMMVC8915E poderá ser exibida. Ao configurar endereços IP iSCSI em um novo grupo de E/S, certifique-se de designar o endereço IP para uma porta desconfigurada e de usar a sinalização -force para a designação de IP.

port_id
(Obrigatório) Especifica a qual porta (1, 2, 3 ou 4) aplicar as mudanças.

Description

O comando cfgportip configura o endereço IP de uma porta Ethernet para iSCSI, ou configures a MTU de um grupo de portas. Esse comando designa um endereço ou IPv4 ou IPv6 para a porta Ethernet especificada de um nó. O endereço IP é usado para a E/S do iSCSI. Use o comando chsystemip para designar endereços IP do sistema em cluster.

Lembre-se: Quando os endereços IP estivem configurados com o mesmo ID do grupo de portas de replicação remota (para redundância) para cada nó de um grupo de E/S, certifique-se de que a mesma porta Ethernet para ambos os nós seja usada durante a configuração. A MTU é configurada usando portas Ethernet simétricas do mesmo grupo de E/S. Para certificar-se de que grupos de portas de replicação remota alternativos funcionem com as mesmas configurações de MTU, portas Ethernet simétricas devem ser configuradas para grupos de portas de replicação remota.

Para um endereço IPv4, os parâmetros ip, mask e gw são obrigatórios. Todos os parâmetros de IP IPv4 devem ser especificados para designar um endereço IPv4 a uma porta Ethernet.

Para um endereço IPv6, os parâmetros ip_6, prefix_6 e gw_6 são obrigatórios. Todos os parâmetros IP IPv6 devem ser especificados para designar um endereço IPv6 a uma porta Ethernet.

Se um endereço IP for especificado para um host, a porta especificada poderá ser descoberta por hosts usando o servidor iSNS (ou outros mecanismos de descoberta como SendTargets). Esses endereços IP não são relatados para sistemas parceiros a fim de criar sessões TCP que são usadas para cópia remota. Essas portas também não podem ser utilizadas para efetuar login e para descoberta de controladores de armazenamento iSCSI de backend baseada em SendTargets.

Os endereços IP que são especificados para cópia remota não podem ser descobertos por hosts, o que significa que não podem ser usados para conexão de host. Estas portas não são relatadas aos sistemas parceiros a fim de criar sessões TCP para cópia remota. Essas portas também não podem ser usadas para efetuar login e para SendTargets ao considerar a descoberta de controladores de armazenamento iSCSI de backend.

Após a configuração de IP, host_port_group_id é designado automaticamente às portas iSCSI. O agrupamento de portas do host agrupa as portas que têm a mesma velocidade e assegura que um máximo de quatro portas sejam descobertas por um host. Os critérios de host_port_group_id adicionais incluem:
  • Um host_port_group_id é um agrupamento automático de portas que é designado por um número inteiro. Os IDs de grupo da porta do host são exclusivos entre os grupos de E/S.
  • Cada ID do grupo de portas do host contém um máximo de quatro portas.
  • Todas as portas em um ID do grupo da porta do host têm velocidades idênticas.
  • IDs do grupo da porta do host idênticos são designados à porta de failover. Se um host_port_group_id já estiver designado a uma porta de failover, o mesmo host_port_group_id será designado a uma porta local.
  • Ativar a sinalização -host como yes designa o host_port_group_id. Se em uma porta com a sinalização do host no , a sinalização do host estiver configurada como yes , resultará na designação de um host_port_group_id a uma porta.
  • Desativar a sinalização para no remove o ID do grupo de portas do host associado a uma porta iSCSI.

Endereços IP que são especificados para armazenamento não podem ser descobertos por hosts, o que significa que não podem ser utilizados para conexão de host. Estes endereços IP não são relatados para sistemas parceiros para criar e configurar sessões TCP para cópia remota.

Para utilizar o mesmo endereço IP para ambas as funções, de conexão de armazenamento de backend e de E/S do host (mas não para cópia remota):
  • O parâmetro -host deve ser configurado como yes.
  • O parâmetro -storage deve ser configurado como yes.
  • O parâmetro -remotecopy deve ser configurado como no.
Nesses casos, esses endereços IP podem ser descobertos pelos hosts. Estes endereços IP também podem ser utilizados para descoberta do controlador de armazenamento de backend e login para migração e virtualização baseadas em iSCSI.
Para utilizar o mesmo endereço IP para ambas as funções, de conexão de armazenamento de backend e de cópia remota (mas não para operações de E/S do host):
  • O parâmetro -storage deve ser configurado como yes.
  • O parâmetro -remotecopy deve ser especificado com o ID do grupo da porta de cópia remota necessário.
  • O parâmetro -host deve ser configurado como no.
Em tais casos, esses endereços IP podem ser utilizados para descobrir e se conectar aos controladores de armazenamento iSCSI de backend. Estes endereços IP também podem ser utilizados para cópia remota baseada em IP.
Para utilizar o mesmo endereço IP para ambas as funções, de E/S do host e de cópia remota (mas não para funções de conexão de armazenamento de backend):
  • O parâmetro -host deve ser configurado como yes.
  • O parâmetro -remotecopy deve ser chamado com o ID do grupo da porta de cópia remota necessário.
  • O parâmetro -storage deve ser configurado como no.
Em tais casos, esses endereços IP podem ser descobertos por hosts, bem como usados para cópia remota baseada em IP, mas não para conexão de armazenamento de backend.

Use o comando lsportip com o parâmetro opcional ethernet_port_id para listar os endereços IP de porta para a porta especificada.

Lembre-se:

Se cfgportip for usado para modificar o endereço IP associado a uma porta Ethernet específica sem especificar um novo ID de VLAN, o novo endereço IP (modificado) herdará a configuração do ID de VLAN existente do endereço IP anterior (IPv4 ou IPv6).

Um exemplo de chamada para IPv4

cfgportip -node 1  -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 1

A saída do resultado:

No feedback

Um exemplo de chamada para IPv6

cfgportip -node 1  -ip_6 3:3:0:4::0  -gw_6 ffe8::0  -prefix_6 64 2

A saída resultante:

Sem feedback

Um exemplo de chamada para configurar uma MTU de 1600 na porta 1 no grupo de E/S 0

cfgportip  –mtu 1600 -iogrp 0 1

A saída do resultado:

Sem feedback

Um exemplo de chamada para configurar uma MTU para seu valor padrão

cfgportip  –defaultmtu -iogrp 0 1

A saída resultante:

Nenhum feedback

Um exemplo de chamada configurando um novo endereço IPv4 para replicação com base em IP

cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –remotecopy 1 –host no -host_6 no 1

A saída resultante:

No feedback

Um exemplo de chamada configurando um novo endereço IPv4 para a conexão do host

cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –host yes 1

A saída resultante:

No feedback

Um exemplo de chamada configurando a replicação para um endereço IPv6 existente

cfgportip -node 1 –remotecopy_6 2 1

A saída resultante:

No feedback

Um exemplo de chamada configurando a conexão de host para um novo endereço IPv6

cfgportip -node 1 –ip_6 2001:db8::1:0:0:1 –host_6 yes 1

A saída resultante:

No feedback

Um exemplo de chamada configurando um novo endereço IPv4 com o ID de VLAN 105

cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –vlan 105 1

A saída resultante:

No feedback

Um exemplo de chamada para configurar um novo endereço IPv6 com o ID de VLAN 1063

cfgportip -node 1 -ip_6 2001:db8::1:0:0:101 -prefix_6 64 -gw_6 2001:db8::1:0:0:1 -vlan_6 1063 1

A saída resultante:

No feedback

Um exemplo de chamada para configurar um novo endereço IPv4 para a função de conexão de armazenamento de backend usando iSCSI

cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –storage yes -remotecopy 0 –host no 1
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –storage yes –host no 1

A saída do resultado:

No feedback

Um exemplo de chamada para configurar um novo endereço IPv4 para conexão de host somente

cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –host yes -storage no 1
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –host yes -storage no -remotecopy 0 1
cfgportip -node 1  -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 1

A saída resultante:

Nenhum feedback

Um exemplo de chamada para configurar um novo endereço IPv4 para replicação baseada em IP

cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 -storage no –remotecopy 1 –host no 1

A saída resultante:

Nenhum feedback

Um exemplo de chamada para configurar a função de conexão de armazenamento para um novo endereço IPv6

cfgportip -node 1 –ip_6 2001:db8::1:0:0:1 –storage_6 yes 1
cfgportip -node 1 –ip_6 2001:db8::1:0:0:1 1

A saída resultante:

Nenhum feedback

Um exemplo de chamada para mudar a especificação de armazenamento para um endereço IPv6 existente

cfgportip -node 1 –storage_6 no 1
cfgportip -node 1 –storage_6 yes 1

A saída resultante:

No feedback